home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / cmds / restore / restore.man < prev   
Text File  |  1990-07-03  |  2KB  |  52 lines
  1. '\" Copyright 1989 Regents of the University of California
  2. '\" Permission to use, copy, modify, and distribute this
  3. '\" documentation for any purpose and without fee is hereby
  4. '\" granted, provided that this notice appears in all copies.
  5. '\" The University of California makes no representations about
  6. '\" the suitability of this material for any purpose.  It is
  7. '\" provided "as is" without express or implied warranty.
  8. '\" 
  9. '\" $Header$
  10. '/" 
  11. .so \*(]ltmac.sprite
  12. .HS RESTORE cmds
  13. .BS
  14. .SH NAME
  15. restore \- Restore a file, or set of files from a dump archive.
  16. .SH SYNOPSIS
  17. \fBrestore\fR [\fIoptions\fR] \fIpath1 path2 ...\fR
  18. .SH OPTIONS
  19. .IP "\fB\-f \fIfilename\fR" 15
  20. Use \fIfilename\fR as the name of the dump archive instead of the default.
  21. .IP "\fB\-help \fR" 15
  22. Print a help message.
  23. .IP "\fB\-n filenumber\fR" 15
  24. If there are multiple files in the archive, use file number \fBfilenumber\fR.
  25. .IP "\fB\-r \fR" 15
  26. Restore using relative pathnames.  The leading '/' is stripped off.
  27. .IP "\fB\-t \fR" 15
  28. Print the table of contents for the dump archive.
  29. .IP "\fB\-v \fR" 15
  30. Verbose.  The name of each file is listed as it is dumped.
  31. .BE
  32.  
  33. .SH DESCRIPTION
  34. .PP
  35. The \fBrestore\fR command is used to restore a file or set of files
  36. from a dump archive.  The dump archive is created by the \fBdump\fR
  37. command.  If a specified path is a single file, then that file
  38. is restored.  If it is a directory, all files contained in that
  39. directory will be recursively restored.  If the path is a 
  40. shell syntax regular expression, then all files in the dump archive
  41. matching the expression will be restored.
  42.  
  43. All the specified paths should be absolute, hard paths.  I.e., they
  44. should start with the root directory, and should not contain any
  45. symbolic links.  Be especially careful when restoring something to
  46. your home directory because most home directories on Sprite are symbolic
  47. links from the /users directory.
  48.  
  49. .SH KEYWORDS
  50. dump, restore, tape, backup, tar
  51.  
  52.